home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 002a / wa_126.zip / SYSOP.TXT < prev    next >
Text File  |  1991-10-06  |  10KB  |  250 lines
  1.  
  2.                       WIZARD'S ARENA -- RELEASE 1.26
  3.                    (C) Copyright 1991 by Douglas Summers
  4.  
  5.                             SYSOP DOCUMENTATION
  6.  
  7.  
  8.    To all you new users, thank you for trying out Wizard's Arena.  If
  9.    you're not a new user, refer to UPGRADE.TXT for instructions on
  10.    upgrading to the new version.
  11.  
  12.    The Wizard's Arena is a BBS door game, allowing a  number of players
  13.    to wander around in a large maze-like area and fight it out, using a
  14.    wide variety of spells and a certain amount of  ironmongery.  Further
  15.    details on the setting of the game -- and on actual play -- can be
  16.    found in the player's documentation.
  17.  
  18.  
  19.    BEFORE WE GET STARTED
  20.    ---------------------
  21.    Check your distribution files.  You should have the following :
  22.  
  23.      WIZARD.EXE      -- the game itself
  24.      DAY.EXE         -- to do daily maintenance off-line
  25.      UPGRADE.EXE     -- the database-upgrade program
  26.  
  27.      WIZARD.TXT      -- the player documentation
  28.      COMMAND.TXT     -- the on-line quick-help file
  29.      CHANGES.TXT     -- a list of the modifications since 1.00
  30.      SYSOP.TXT       -- this documentation
  31.      COPYRIGH.TXT    -- the copyright notice for the game, & legal stuff
  32.      UPGRADE.TXT     -- how to upgrade from older versions
  33.      CONFIG.TXT      -- how to customize the game
  34.  
  35.      DATABASE.ZIP    -- the initial game databases (see notes, below)
  36.      DOOR.SYS        -- used to run in LOCAL mode
  37.      README.1ST      -- a file that tells you to read this file.
  38.  
  39.    There may also be a README.TXT.  If one exists, you should read
  40.    it IMMEDIATELY.  If there isn't one, don't worry about it.  There
  41.    may also be an ADS.TXT file, which will be a small file describing
  42.    other games you might be interested in.  If it's not there, don't
  43.    sweat it particularly, either.
  44.  
  45.    Other than README.TXT and/or ADS.TXT, if any of these files are
  46.    missing or there are 'extra' files, I suggest you delete this
  47.    stuff off your disk and get a copy from a 'known clean' source.
  48.  
  49.  
  50.    SETTING UP (NEW USERS ONLY)
  51.    ---------------------------
  52.  
  53.       1. Make a directory for the game.  For example, D:\WIZARD.
  54.  
  55.       2. Copy all the distribution files into that directory.
  56.          All the files should remain together; the game looks in its
  57.          own directory for the databases and text files (although
  58.          that directory needn't be the CURRENT directory at the
  59.          time the program is run).
  60.  
  61.       3. Unzip DATABASE.ZIP.
  62.  
  63.       4. Set up a batch file to run the program.  See the following
  64.          section for details.
  65.           
  66.       5. Run UPGRADE.EXE.  This will generate a small file named 
  67.          "CONFIG.WA".  You should customize it, at the very least to
  68.          specify your BBS's name.  Please refer to CONFIG.TXT for
  69.          details.
  70.  
  71.  
  72.    SETTING UP THE BATCH FILE
  73.    -------------------------
  74.    You'll need to make a batch file to call the program with.  The line
  75.    actually calls the game can look something like this:
  76.  
  77.        C:\WIZARD\WIZARD C:\PCB\PCBOARD.SYS
  78.  
  79.    The directory the game is in doesn't need to be on your path;
  80.    of course, your batch file must be.
  81.  
  82.    The only parameter to the program is the location (full path-and-
  83.    filename) of the door-information file for your BBS.  Different BBS
  84.    types use different ones, so if you're not sure how to set this up,
  85.    just refer to your BBS documentation.
  86.  
  87.    You'll have to make sure that only 1 player can get in at a time.
  88.    THIS IS VERY IMPORTANT.  IF TWO USERS ARE IN THE GAME AT THE SAME
  89.    TIME IT IS LIKELY (THOUGH NOT CERTAIN) TO CAUSE TROUBLE.
  90.    The batch file  should look something like this (this example is for
  91.    PCBoard):
  92.  
  93.        IF EXIST pcboard.txt GOTO inuse
  94.        COPY inuse.txt pcboard.txt
  95.        C:\WIZARD\WIZARD C:\PCB\PCBOARD.SYS
  96.        DEL pcboard.txt
  97.        :inuse
  98.        board.bat    (crank the bbs back up, pcb displays pcboard.txt)
  99.   
  100.  
  101.    RUNNING LOCALLY
  102.    ---------------
  103.    The game can be run locally simply by calling it directly with a
  104.    command-line parameter of "DOOR.SYS".  This causes the game to
  105.    use that file (provided with the game) instead of the door-
  106.    information file normally employed.  It'll prompt you for a user's
  107.    name; any user in the game is available to you.
  108.  
  109.  
  110.    REGISTERING
  111.    -----------
  112.    Registering the game is pretty easy.  After you've run the UPGRADE
  113.    program, there will be a file named "REGISTER.ME" in the directory
  114.    with the WIZARD databases.    It says something like:
  115.      
  116.                     THE KEY SEQUENCE IS XXXXXXXXXX
  117.  
  118.    (the X's will be replaced with your particular key sequence).
  119.     
  120.    Simply drop me a letter, with this key sequence and $15 enclosed.
  121.    I'll need a return address; I'd also like to know the name of
  122.    your BBS and its phone-number.
  123.  
  124.    After the post office has done its glacial best to lose the letter,
  125.    I will return to you (via a postcard) a similar sequence of
  126.    numbers and some letters (along with my eternal gratitude).  Simply
  127.    edit your CONFIG.WA file to have a line in it that says:
  128.      
  129.         REGISTRATION = XXXXXXXX
  130.          
  131.    (where the X's are replaced by the registration sequence I send you).
  132.    The game will now 'know' its registered, will be overjoyed to see
  133.    that you support a starving shareware artist, and will gleefully
  134.    permit the registration-specific parameters to take effect.
  135.  
  136.    The address to send your hard-earned cash and Key Sequence are:
  137.   
  138.                 Douglas Summers        (even though I like 'Rick' better)
  139.                 PO Box 671652
  140.                 Marietta, GA 30067-0028
  141.   
  142.    Any comments you have about the game are more than welcome, 
  143.    particularly if accompanied by cash.
  144.  
  145.    Please Note: The key sequence, and therefore the registration sequence,
  146.    are based partly on the BBS name you set up in CONFIG.WA.  If you
  147.    need to change the name of your board, you'll need a new registration
  148.    sequence; contact the author in this eventuality.
  149.  
  150.  
  151.    SYSOP FUNCTIONS
  152.    ---------------
  153.    The author is very much indebted to Rickie Belitz for his excellent
  154.    CKIT library for the nuts-and-bolts of door handling.  Since I don't
  155.    have the source-code to this shareware library, my ability to support
  156.    it is limited.  If any problems come up, though, I'll try.  I've culled
  157.    a small amount of documentation from his text files, to describe the
  158.    features that my program provides via his library.
  159.  
  160.    Certain functions are allowed to the sysop while the remote user is
  161.    running the door.
  162.  
  163.    These (as drawn from his documentation) are:
  164.  
  165.        Function Key
  166.        ------------
  167.            F5           Shell to DOS
  168.            F8           Return user to system
  169.            F9           Toggle display
  170.            F3           Toggle Printer         (PCBoard only)
  171.            F4           Toggle Bell            (PCBoard only)
  172.            F7           Toggle Caller Alarm (PCBoard Only)
  173.            Alt-H        Toggle status line
  174.            Alt-N        Toggle sysop on next
  175.            Alt-X        exit to DOS after call
  176.    
  177.  
  178.    IF ERRORS OCCUR...
  179.    ------------------
  180.    If an error should happen during game-play, the user will be
  181.    dumped back to the BBS and a file named ERRORS.OUT will contain
  182.    specific information about the error.
  183.  
  184.    Try fixing the obvious things -- low RAM, not enough file handles,
  185.    and so on.  If you're running on a network, make sure that only
  186.    one node at a time can be in the game.  Then try restoring from
  187.    the backup that you so    prudently keep.  If the problem persists,
  188.    try running the UPGRADE    program; it does a small amount of error-
  189.    detection and -correction,    even when it doesn't need to convert
  190.    anything.
  191.  
  192.    If none of these things work, contact the author.  He'll try to
  193.    sort it out.
  194.  
  195.    After errors are resolved, you might want to delete (or at least
  196.    edit) the error-log, ERRORS.OUT.  The game makes no effort to do so.
  197.  
  198.  
  199.    BACKING UP
  200.    ----------
  201.    If the program bombs, it might be nice to be able to restore from
  202.    an archive to a state prior to the error.  Therefore, it'd be
  203.    nice to back up the databases from time to time.  
  204.    It isn't a good idea to back up EVERY time someone logs in,
  205.    though -- much time is wasted.  WIZARD.EXE (and DAY.EXE, see below)
  206.    will exit with an errorlevel of 100 if it does the daily maintenance.
  207.  
  208.    You can use this to perform backups on a daily basis. For example:
  209.  
  210.        C:\WIZARD\WIZARD C:\PCB\PCBOARD.SYS
  211.        if errorlevel 100 goto DAILY
  212.        goto no_backup
  213.        :daily
  214.        PKZIP daily wa0*.*
  215.        goto no_backup
  216.        :no_backup
  217.  
  218.    The only files that need to be archived are the databases, which
  219.    have a filespec "WA*.*".
  220.  
  221.  
  222.    DAILY MAINTENANCE
  223.    -----------------
  224.    The first user to enter the game on a given day triggers the daily
  225.    maintenance; this is a process that distributes random monsters and
  226.    items, gives everyone their AP/FP allotment and moves the NPCs.
  227.  
  228.    It can take from a few seconds to a few minutes, depending on the 
  229.    number of NPCs wandering around and the speed of your computer;
  230.    you might, therefore, want to do it off-line.
  231.  
  232.    To this end, there is a program named 'DAY.EXE'.  It takes the same
  233.    parameters as WIZARD.EXE does, but ignores the ones not relating
  234.    to daily maintenance.  All it does is run the daily maintenance, if
  235.    it hasn't already been run that day (by DAY.EXE or WIZARD.EXE).
  236.  
  237.    I recommend that you simply put a call to it in the 'system event'
  238.    stuff (which is often used for getting/processing mail and so forth).
  239.    That way, your users will never have to sit through it.
  240.  
  241.    Use of DAY.EXE is entirely optional; if it doesn't do the daily
  242.    maintenance on schedule, WIZARD.EXE will.
  243.     DAY.EXE, like the daily maintenance in WIZARD.EXE itself, is smart
  244.    enough to just do nothing if its run more than once on a given
  245.    day.
  246.  
  247.    DAY.EXE is subject to the same one-user-at-a-time limit as is
  248.    WIZARD.EXE and UPGRADE.EXE.  None of these should be run while
  249.    any of the others is also running.
  250.